home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / relnotes / Outbox / ch2.z / ch2
Text File  |  2001-04-17  |  12KB  |  397 lines
  1.  
  2.  
  3.  
  4.                                   - 1 -
  5.  
  6.  
  7.  
  8.        2.  _I_n_s_t_a_l_l_a_t_i_o_n__I_n_f_o_r_m_a_t_i_o_n
  9.  
  10.        This chapter lists supplemental information to the _I_R_I_S
  11.        _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _G_u_i_d_e.  The information listed here is
  12.        product- and release-specific; use it with the Installation
  13.        Guide to install this product.
  14.  
  15.        2.1  _O_u_t_B_o_x__S_u_b_s_y_s_t_e_m_s
  16.  
  17.        OutBox includes these subsystems:
  18.  
  19.        _o_u_t_b_o_x._s_w._o_u_t_b_o_x              Web and desktop tools to
  20.                                      create, publish to, and manage
  21.                                      an OutBox Personal Web Site.
  22.  
  23.        _o_u_t_b_o_x._b_o_o_k_s._O_u_t_b_o_x_H_e_l_p       Online help documents for the
  24.                                      OutBox software.
  25.  
  26.        _o_u_t_b_o_x._m_a_n._o_u_t_b_o_x             Man pages for the OutBox Motif
  27.                                      publishing application and the
  28.                                      WebDist software.
  29.  
  30.        _o_u_t_b_o_x._m_a_n._r_e_l_n_o_t_e_s           The product release notes.
  31.  
  32.        _o_u_t_b_o_x._s_w._w_e_b_d_i_s_t             Webdist software that allows
  33.                                      the creation of software
  34.                                      installation pages.
  35.  
  36.  
  37.        2.2  _I_n_s_t_a_l_l_a_t_i_o_n__M_e_t_h_o_d
  38.  
  39.        All of the subsystems for OutBox can be installed using
  40.        IRIX.  You do not need to use the miniroot. Refer to the
  41.        _I_R_I_S _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _G_u_i_d_e for complete installation
  42.        instructions.
  43.  
  44.  
  45.        2.3  _P_r_e_r_e_q_u_i_s_i_t_e_s
  46.  
  47.        This software requires IRIX 6.5.  The following packages
  48.        must be installed:
  49.  
  50.           +o desktop_base.sw.utilities
  51.  
  52.           +o desktop_eoe.sw.envm
  53.  
  54.           +o desktop_tools.sw.tools
  55.  
  56.           +o eoe.sw.gifts_perl
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                                   - 2 -
  71.  
  72.  
  73.  
  74.           +o eoe.sw.gifts_perl_lib
  75.  
  76.           +o imgtools.sw.tools
  77.  
  78.           +o ns_fasttrack.sw.server
  79.  
  80.  
  81.        If you have a video camera installed, and wish to use the
  82.        OutBox web camera page, and snapshot features, install the
  83.        following package:
  84.  
  85.           +o dmedia_eoe.sw.tools
  86.  
  87.  
  88.        2.4  _R_u_n_n_i_n_g__w_i_t_h__O_t_h_e_r__S_e_r_v_e_r_s
  89.  
  90.        OutBox can run with any HTTP/1.0 compliant web server that
  91.        supports CGI-BIN, server parsed HTML and User Directory
  92.        mappings.
  93.  
  94.        Using a web server other than the default is not a supported
  95.        configuration.  However, you can configure your web server
  96.        to run OutBox.  The server must be configured to support the
  97.        following:
  98.  
  99.  
  100.           +o a document root of /var/www/htdocs,
  101.  
  102.           +o a cgi-bin directory of /var/www/cgi-bin
  103.  
  104.           +o a user directory mapping of the URL substring
  105.             "/~username" to the file path "~username/public_html"
  106.  
  107.           +o server-parsed HTML enabled for filenames with the
  108.             suffix ".shtml".
  109.  
  110.        NNNNooootttteeee::::  This is not a supported configuration.
  111.  
  112.  
  113.        2.5  _C_h_a_n_g_e_s__i_n__t_h_i_s__r_e_l_e_a_s_e
  114.  
  115.  
  116.        Several new features were added to this release to improve
  117.        the OutBox web publishing and folder management process.
  118.        These changes are described in the Help pages available from
  119.        the new OutBox toolbars on the OutBox system and user pages.
  120.  
  121.        Less visible changes are described in this section.
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.                                   - 3 -
  137.  
  138.  
  139.  
  140.        2.5.1  _S_e_c_u_r_i_t_y__f_i_x_e_s
  141.  
  142.        Previous versions of OutBox had several security problems
  143.        which could allow a remote user to access private system
  144.        information. All known security problems have been fixed in
  145.        this release. The fixes are also available as patches for
  146.        all previous releases of OutBox on IRIX.
  147.  
  148.  
  149.        Side effects: The fixes for these security-related bugs
  150.        required removal of the functionality responsible for the
  151.        security problems. The resulting changes in OutBox behavior
  152.        are described below:
  153.  
  154.           +o When a user's OutBox folders are first created, a
  155.             symbolic link is no longer created between
  156.             /var/www/htdocs/username and ~username/public_html.
  157.             This means that an OutBox URL of the form
  158.             "http://host/username/myfile.doc" will no longer work.
  159.             The correct form is "http://host/~username/myfile.doc"
  160.             (i.e. a "~" is added to the username.)
  161.  
  162.           +o On the OutBox user page, published files no longer
  163.             display the "(download)" link. This link provided the
  164.             user with a way to download a document without viewing
  165.             it. This feature was not secure, and has been removed.
  166.             The secure way to download a document is by using the
  167.             browser 'Save Link As' feature. (In Netscape, press
  168.             Shift-Button1 on the OutBox file, or press the right
  169.             mouse button over the link to access the feature via a
  170.             popup menu.)
  171.  
  172.           +o The script "/cgi-bin/wrap" has been modified. A URL
  173.             containing the text "/cgi-bin/wrap" can no longer be
  174.             used to view a document.  To access a document from
  175.             such a URL, simply remove the text "/cgi-bin/wrap" from
  176.             the URL.  Note: the "/cgi-bin/wrap" script is still
  177.             used in URL's pointing to OutBox folders. URL's
  178.             pointing to OutBox folders should not be modified.
  179.  
  180.           +o The script "/cgi-bin/handler" has been disabled. A URL
  181.             containing the text "/cgi-bin/handler" can no longer be
  182.             used to download a document. To access the document
  183.             from such a URL, remove the text "/cgi-bin/handler"
  184.             from the URL.
  185.  
  186.           +o The script "/cgi-bin/webdist.cgi" has been disabled for
  187.             security reasons.  To generate a Web Software
  188.             Distribution Page, use the tool "/usr/etc/webdist" from
  189.             the command line. See the "webdist(1)" man page for
  190.             more information.
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.                                   - 4 -
  203.  
  204.  
  205.  
  206.        2.5.2  _A_d_d_i_n_g__a__n_e_w__u_s_e_r
  207.  
  208.        In previous releases, the script /var/www/server/addUser.sh
  209.        was used to create the OutBox for a new user. This script
  210.        has been replaced by the script
  211.        /var/X11/xdm/firsttime/outbox.
  212.  
  213.        This script is run automatically the first time a new user
  214.        logs in to the desktop. If you wish to configure a user's
  215.        OutBox without requiring them to log in to the desktop,
  216.        login as the user via the command line as the user and type:
  217.  
  218.        /var/X11/xdm/firsttime/outbox
  219.  
  220.  
  221.        2.5.3  _S_e_r_v_e_r__S_i_d_e__I_n_c_l_u_d_e__f_i_l_e__t_y_p_e
  222.  
  223.        Previous releases of OutBox required the web server to be
  224.        configured to parse all files with the suffix ".html" for
  225.        Server Side Include directives.  This slows server
  226.        performance needlessly.
  227.  
  228.        This release requires a server configured to parse only
  229.        files specifically marked as using Server Side Includes by
  230.        using the suffix ".shtml".  When accessing a directory, the
  231.        server is configured to look first for the file
  232.        "index.shtml", then for "index.html".
  233.  
  234.  
  235.        2.5.4  _U_p_g_r_a_d_e_d__S_y_s_t_e_m__a_n_d__U_s_e_r__w_e_b__p_a_g_e_s
  236.  
  237.        The new OutBox features require changes in the 6.2 OutBox
  238.        system and user web pages. The installation procedure
  239.        attempts to perform these changes automatically. If you have
  240.        changed your pages from the 6.2 defaults, this process may
  241.        fail. You will need to manually merge your existing files
  242.        with the new OutBox files. These files are:
  243.  
  244.           +o System web page: /var/www/htdocs/index.html, and
  245.             index.html.N
  246.  
  247.           +o User web page: ~/public_html/index.html and
  248.             index.html.N
  249.  
  250.        When you merge the files, be careful not to delete the
  251.        comment lines marked "DO NOT REMOVE".
  252.  
  253.  
  254.        2.5.5  _W_e_b__C_a_m_e_r_a__P_a_g_e
  255.  
  256.        The System page toolbar contains a button labeled "Camera".
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.                                   - 5 -
  269.  
  270.  
  271.  
  272.        Clicking on this button will display the OutBox Camera page.
  273.        This page contains a snapshot taken from the system video
  274.        camera, if one is installed.
  275.  
  276.        The camera snapshot feature is disabled by default to
  277.        prevent broadcast of the video camera image without a user's
  278.        knowledge. To enable the snapshot feature, log in as root,
  279.        and edit the file /var/www/cgi-bin/sgi-camera/snap. Change
  280.        the setting of 'camera' to 'camera="ENABLED"'.
  281.  
  282.        _N_o_t_e: The snapshot is published to the web, and will be
  283.        visible to all visitors to your OutBox camera page.
  284.  
  285.  
  286.  
  287.        2.6  _K_n_o_w_n__p_r_o_b_l_e_m_s
  288.  
  289.  
  290.        This section describes known problems or bugs in this
  291.        release of OutBox
  292.  
  293.  
  294.        2.6.1  _U_s_i_n_g__a_n__H_T_T_P__P_r_o_x_y__s_e_r_v_e_r
  295.  
  296.        The OutBox pages will not display the page owner's toolbar
  297.        options such as Edit or Publish if your browser is
  298.        configured to use an HTTP Proxy server.
  299.  
  300.        The workaround for Netscape is to go to the Proxies panel in
  301.        the Network Preferences dialog. View the manual settings. If
  302.        you have a Proxy configured for HTTP, then add the following
  303.        information to the "No Proxy For" field:  "localhost,
  304.        hostname, hostname.domainname". For example, a machine
  305.        pacifica.eng.sgi.com should have the entry:
  306.        "localhost,pacifica,pacifica.eng,pacifica.eng.sgi.com"
  307.  
  308.  
  309.  
  310.        2.6.2  _U_s_i_n_g__H_T_M_L__F_R_A_M_E_'_s__i_n__O_u_t_B_o_x__p_a_g_e_s
  311.  
  312.        If a user's OutBox page contains an HTML FRAMESET, sub-
  313.        frames containing toolbar and folder icons will not behave
  314.        as expected.  Clicking on them will load the new page into
  315.        the same sub-frame, rather than the toplevel frame.
  316.  
  317.        The workaround is to place the following line in any HTML
  318.        file included in a FRAMESET which references the OutBox
  319.        toolbar(/cgi-bin/outbox-cgi), or folder listing (/cgi-
  320.        bin/wrap):
  321.  
  322.        <HEAD>
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.                                   - 6 -
  335.  
  336.  
  337.  
  338.           <BASE TARGET="_parent">
  339.  
  340.        </HEAD>
  341.  
  342.        This will ensure that the results of any links will be
  343.        displayed in the toplevel frame.
  344.  
  345.  
  346.  
  347.        2.6.3  _B_r_o_k_e_n__l_i_n_k_s__a_n_d__i_m_a_g_e_s__i_n__a_n__O_u_t_B_o_x__p_a_g_e
  348.  
  349.        Links, images or frame sources in OutBox HTML pages will not
  350.        reliably work if they are specified as being relative to the
  351.        OutBox page document.  For example: <IMG SRC="hello.gif">
  352.        will not always find the image.
  353.  
  354.        There are two workarounds:
  355.  
  356.           +o Use absolute links in all OutBox pages. For example,
  357.             specify an image as:
  358.  
  359.             <IMG SRC="/~myusername/MyFolder/hello.gif">
  360.  
  361.  
  362.           +o Specify a base url for your document. For example, the
  363.             HTML page index.html in the folder MyFolder should
  364.             specify:
  365.  
  366.             <HEAD>
  367.  
  368.                <BASE HREF="http://myhost/~myusername/MyFolder">
  369.  
  370.             </HEAD>
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.